home *** CD-ROM | disk | FTP | other *** search
/ Aminet 3 / Aminet 3 - July 1994.iso / Aminet / game / patch / civman.lha / CivMan / CivManager.doc < prev    next >
Encoding:
Text File  |  1992-02-26  |  6.7 KB  |  219 lines
  1.  
  2.            CivManager V1.3 - By Paul Hickman (ph@doc.ic.ac.uk)
  3.            ===================================================
  4.  
  5.  
  6. Disclaimer
  7. ----------
  8.  
  9.  
  10.     This  product  is  not  in  any  way  endorsed  by,  or connected to
  11.     MircoProse  Software  Ltd.,  or  the  authors of civilisation.  This
  12.     software  is  supplied  on an "as is" basis  -  I  accept  no  legal
  13.     responsibility if it does  not  perform as documented, or causes any
  14.     other problems to your system.
  15.  
  16.     Civilization is Microprose Software's trademark for it's simulation
  17.     of human history.
  18.  
  19.  
  20.  
  21.  
  22. Files
  23. -----
  24.  
  25.     Civman/Civmanager        The program.
  26.  
  27.     Civman/Civmanager13.e    The source code.
  28.  
  29.     Civman/Civmanager.doc    This file.
  30.  
  31.     Civman/DevSaveIcon.info    The icon used for saved games.
  32.  
  33.     Civman/Install_Civmanager    The commodore installer script
  34.  
  35.     Civman/Reqtools.library    Nica Francois' reqtools library
  36.  
  37.  
  38.  
  39.  
  40. Overview
  41. --------
  42.  
  43.     Civilisation  is  an  absolutely  brilliant  game,  but  it is sadly
  44.     lacking  when it comes to saving games - you must save them  to  the
  45.     root directory of a disk, and they have names like 'CIVIL0.map' etc.
  46.     which make it impossible to workout which game is which from outside
  47.     civilization.  CivManager fixes this, allowing you to save your game
  48.     to any location, with any filename, and as a single file.
  49.  
  50.  
  51.  
  52.  
  53. Requirements
  54. ------------
  55.  
  56.     A Copy of CivilizationAGA.
  57.  
  58.     A Hard Disk Drive (CivManager will work on a floppy disk,
  59.                        but is totally pointless to use it, since
  60.                        you save the root dir anyway)
  61.  
  62.     2Mb of chip memory. (Well, CivManager only uses around
  63.     20k, but civilization needs 2Mb)
  64.  
  65.     Workbench 3.0 (Civmanager only needs 2.04, but CivAGA needs 3.0)
  66.  
  67.     The Commodore Installer Utility (Recommend, but not neccessary)
  68.  
  69.  
  70.  
  71.  
  72.  
  73. Installation
  74. ------------
  75.  
  76.     To  install  CivManager  -  Simply Click on the "Install-Civmanager"
  77.     icon. If the commodore "Installer"  program  is  not on your current
  78.     path,  you  must  set  the default tool of this icon to  the  actual
  79.     location  of  your installer  with  workbenches  "information"  menu
  80.     option.
  81.  
  82.  
  83.     To install by hand:
  84.  
  85.     1) Copy "CivManager" & "DefSaveIcon.info" to your CivAga directory.
  86.  
  87.     2) Copy Reqtools.library to your LIBS: if you don't already have it.
  88.  
  89.     4) Rename the icon CivilizationAGA.info to CivManager.info
  90.  
  91.     3) Set the tooltypes of this CivManager icon:
  92.  
  93.     CIV=<Your civAGA directories path>
  94.         FONTS=<Your civilization fonts path>
  95.         DIR=<Your Default Game saves directory path>
  96.  
  97.        You can leave out the FONT= line if your civilization fonts are
  98.        in civAGA/Fonts, where they are put by the civilization install 
  99.        script.
  100.  
  101.            
  102.     4) Remove the 5 assigns (CIV1:, ... , CIV4: and FONTS:) from your
  103.        s:user-startup file that were put there by the civilization
  104.        installer program - this is done by Civmanager at runtime.
  105.  
  106.  
  107.  
  108.  
  109. Starting A New Game Of Civilization
  110. -----------------------------------
  111.  
  112.     To begin a new game of civilization under CivManger, double click
  113.     the CivManager Icon.  When the reqtools filerequester appears,
  114.     enter the name of a new file to save the game to.  (I recommend you
  115.     end the name in ".Civil", as the default pattern of the
  116.     filerequester is to only list "#?.Civil" files).  This allows you to
  117.     give your files descriptive names, instead of "Civil0.map", and put
  118.     them in a sub-directory.
  119.  
  120.     When  the  civilization  title  screen appears, select Start Game as
  121.     usual, but when you come to save  the  game,  save  it  to  the  top
  122.     position  on the RAM: disk. Whenever you save to the top position on
  123.     the RAM: disk,  CivMangaer  will  copy  your  saved game to your the
  124.     .Civil file.
  125.  
  126.  
  127.  
  128.  
  129. Loading an Existing Game Of Civilization
  130. ----------------------------------------
  131.  
  132.     To continue a game, simply select the '.Civil' file to load from the
  133.     file  requester.  When the civilization title screen appears, select
  134.     load game, and load  the top file from the RAM: disk. To resave your
  135.     game, save it back over  this file, and CivMangaer will copy it back
  136.     to disk.
  137.  
  138.     Alternatively, shift-select the .Civil icon of the game you wish
  139.     to play, or double click it, or create a tool manager Exec object
  140.     & App Icon / Dock Icon for CivManager, and make the exec object of
  141.     type WB with the arguments box checkmarked. Then you can drop game
  142.     saves on the icon to load them into civilization, or click on the
  143.     dock icon to bring up the file-requester.
  144.  
  145.  
  146.  
  147.  
  148. Controling CivManager
  149. ---------------------
  150.  
  151.     Civmanager installs itself as a commodity, so it can be quit by:
  152.  
  153.     - Running It Again
  154.  
  155.         - Selecting Remove from Commodities Exchange
  156.  
  157.         - Any other standard way of removing commodities
  158.  
  159.         - You can also quit by deleting the file RAM:CIVIL0.SVE
  160.  
  161.     - CivManager does not quit when you quit civilization
  162.  
  163.     You can also suspend it (Stop it copying the file to harddisk)
  164.     can making it inactive from commodities exchange.
  165.  
  166.     NOTE: I have not implemented any normal commodities tooltypes -
  167.           It does not have an interface, therefore no popup or hotkey.
  168.           It does not intercept the input stream therefore no priority.
  169.  
  170.       I only made it a commodity, because that saved me having to
  171.           build an interface to quit / suspend the program, and it made
  172.           it more system friendly.
  173.  
  174.  
  175.  
  176.  
  177. Converting Existing Civilization Saves To CivManager Files
  178. ----------------------------------------------------------
  179.  
  180.     To convert your existing civilization files, open a shell, and CD to
  181.     the directory containing your saves, then type:
  182.  
  183.         join CIVIL0.map CIVIL0.SVE AS=<Filename>.Civil
  184.  
  185.     Where  <Filename>  is  the  full path & filename of where you wish
  186.     to create the ".Civil" file. Repeat the process for CIVIL1, CIVIL2,
  187.     etc. e.g.
  188.  
  189.     Join CIVIL4.map CIVIL4.SVE AS=MyGame.Civil
  190.  
  191.  
  192.  
  193.  
  194. How Does It Work
  195. ----------------
  196.  
  197.     CivManager  uses  the  new  AmigaDOS  2.04+  Notify  facility to ask
  198.     AmigaDOS  to  inform  it  every  time  the  file  RAM:CIVIL0.SVE  is
  199.     modified. When it is modified, CivManager joins the  .map  and  .SVE
  200.     files, and copies them to the file you selected. If the modification
  201.     made was a delete, the program quits.
  202.  
  203.  
  204.  
  205.  
  206. Credits
  207. -------
  208.  
  209.  
  210.     Many Thanks Go To Wouter van Oortmerssen for the wonderful 'Amiga E'
  211.     language  which  which CivManager was written, Nico Francois for the
  212.     reqtools library,  all  those  who've  distributed installer scripts
  213.     with  their  programs from which I gleamed  enough  information  to
  214.     write the CivManager installer, Commodore for writing the installer,
  215.     Jason Maskell for his example of how to program a commodity in E,
  216.     and of course  Sid  Meier & Microprose for the best amiga game there
  217.     is - Despite the bugs :-(
  218.  
  219.